<html><body>
<style>

body, h1, h2, h3, div, span, p, pre, a {
  margin: 0;
  padding: 0;
  border: 0;
  font-weight: inherit;
  font-style: inherit;
  font-size: 100%;
  font-family: inherit;
  vertical-align: baseline;
}

body {
  font-size: 13px;
  padding: 1em;
}

h1 {
  font-size: 26px;
  margin-bottom: 1em;
}

h2 {
  font-size: 24px;
  margin-bottom: 1em;
}

h3 {
  font-size: 20px;
  margin-bottom: 1em;
  margin-top: 1em;
}

pre, code {
  line-height: 1.5;
  font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}

pre {
  margin-top: 0.5em;
}

h1, h2, h3, p {
  font-family: Arial, sans serif;
}

h1, h2, h3 {
  border-bottom: solid #CCC 1px;
}

.toc_element {
  margin-top: 0.5em;
}

.firstline {
  margin-left: 2 em;
}

.method  {
  margin-top: 1em;
  border: solid 1px #CCC;
  padding: 1em;
  background: #EEE;
}

.details {
  font-weight: bold;
  font-size: 14px;
}

</style>

<h1><a href="retail_v2.html">Vertex AI Search for commerce API</a> . <a href="retail_v2.projects.html">projects</a> . <a href="retail_v2.projects.locations.html">locations</a> . <a href="retail_v2.projects.locations.catalogs.html">catalogs</a> . <a href="retail_v2.projects.locations.catalogs.controls.html">controls</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
  <code><a href="#close">close()</a></code></p>
<p class="firstline">Close httplib2 connections.</p>
<p class="toc_element">
  <code><a href="#create">create(parent, body=None, controlId=None, x__xgafv=None)</a></code></p>
<p class="firstline">Creates a Control. If the Control to create already exists, an ALREADY_EXISTS error is returned.</p>
<p class="toc_element">
  <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
<p class="firstline">Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned.</p>
<p class="toc_element">
  <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
<p class="firstline">Gets a Control.</p>
<p class="toc_element">
  <code><a href="#list">list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
<p class="firstline">Lists all Controls by their parent Catalog.</p>
<p class="toc_element">
  <code><a href="#list_next">list_next()</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<p class="toc_element">
  <code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p>
<p class="firstline">Updates a Control. Control cannot be set to a different oneof field, if so an INVALID_ARGUMENT is returned. If the Control to update does not exist, a NOT_FOUND error is returned.</p>
<h3>Method Details</h3>
<div class="method">
    <code class="details" id="close">close()</code>
  <pre>Close httplib2 connections.</pre>
</div>

<div class="method">
    <code class="details" id="create">create(parent, body=None, controlId=None, x__xgafv=None)</code>
  <pre>Creates a Control. If the Control to create already exists, an ALREADY_EXISTS error is returned.

Args:
  parent: string, Required. Full resource name of parent catalog. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}` (required)
  body: object, The request body.
    The object takes the form of:

{ # Configures dynamic metadata that can be linked to a ServingConfig and affect search or recommendation results at serving time.
  &quot;associatedServingConfigIds&quot;: [ # Output only. List of serving config ids that are associated with this control in the same Catalog. Note the association is managed via the ServingConfig, this is an output only denormalized view.
    &quot;A String&quot;,
  ],
  &quot;displayName&quot;: &quot;A String&quot;, # Required. The human readable control display name. Used in Retail UI. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is thrown.
  &quot;name&quot;: &quot;A String&quot;, # Immutable. Fully qualified name `projects/*/locations/global/catalogs/*/controls/*`
  &quot;rule&quot;: { # A rule is a condition-action pair * A condition defines when a rule is to be triggered. * An action specifies what occurs on that trigger. Currently rules only work for controls with SOLUTION_TYPE_SEARCH. # A rule control - a condition-action pair. Enacts a set action when the condition is triggered. For example: Boost &quot;gShoe&quot; when query full matches &quot;Running Shoes&quot;.
    &quot;boostAction&quot;: { # A boost action to apply to results matching condition specified above. # A boost action.
      &quot;boost&quot;: 3.14, # Strength of the condition boost, which must be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the item a big promotion. However, it does not necessarily mean that the boosted item will be the top result at all times, nor that other items will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant items. Setting to -1.0 gives the item a big demotion. However, results that are deeply relevant might still be shown. The item will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored.
      &quot;productsFilter&quot;: &quot;A String&quot;, # The filter can have a max size of 5000 characters. An expression which specifies which products to apply an action to. The syntax and supported fields are the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Examples: * To boost products with product ID &quot;product_1&quot; or &quot;product_2&quot;, and color &quot;Red&quot; or &quot;Blue&quot;: *(id: ANY(&quot;product_1&quot;, &quot;product_2&quot;)) * *AND * *(colorFamilies: ANY(&quot;Red&quot;, &quot;Blue&quot;)) *
    },
    &quot;condition&quot;: { # Metadata that is used to define a condition that triggers an action. A valid condition must specify at least one of &#x27;query_terms&#x27; or &#x27;products_filter&#x27;. If multiple fields are specified, the condition is met if all the fields are satisfied e.g. if a set of query terms and product_filter are set, then only items matching the product_filter for requests with a query matching the query terms wil get boosted. # Required. The condition that triggers the rule. If the condition is empty, the rule will always apply.
      &quot;activeTimeRange&quot;: [ # Range of time(s) specifying when Condition is active. Condition true if any time range matches.
        { # Used for time-dependent conditions. Example: Want to have rule applied for week long sale.
          &quot;endTime&quot;: &quot;A String&quot;, # End of time range. Range is inclusive.
          &quot;startTime&quot;: &quot;A String&quot;, # Start of time range. Range is inclusive.
        },
      ],
      &quot;pageCategories&quot;: [ # Used to support browse uses cases. A list (up to 10 entries) of categories or departments. The format should be the same as UserEvent.page_categories;
        &quot;A String&quot;,
      ],
      &quot;queryTerms&quot;: [ # A list (up to 10 entries) of terms to match the query on. If not specified, match all queries. If many query terms are specified, the condition is matched if any of the terms is a match (i.e. using the OR operator).
        { # Query terms that we want to match on.
          &quot;fullMatch&quot;: True or False, # Whether this is supposed to be a full or partial match.
          &quot;value&quot;: &quot;A String&quot;, # The value of the term to match on. Value cannot be empty. Value can have at most 3 terms if specified as a partial match. Each space separated string is considered as one term. For example, &quot;a b c&quot; is 3 terms and allowed, but &quot; a b c d&quot; is 4 terms and not allowed for a partial match.
        },
      ],
    },
    &quot;doNotAssociateAction&quot;: { # Prevents `query_term` from being associated with specified terms during search. Example: Don&#x27;t associate &quot;gShoe&quot; and &quot;cheap&quot;. # Prevents term from being associated with other terms.
      &quot;doNotAssociateTerms&quot;: [ # Cannot contain duplicates or the query term. Can specify up to 100 terms.
        &quot;A String&quot;,
      ],
      &quot;queryTerms&quot;: [ # Terms from the search query. Will not consider do_not_associate_terms for search if in search query. Can specify up to 100 terms.
        &quot;A String&quot;,
      ],
      &quot;terms&quot;: [ # Will be [deprecated = true] post migration;
        &quot;A String&quot;,
      ],
    },
    &quot;filterAction&quot;: { # * Rule Condition: - No Condition.query_terms provided is a global match. - 1 or more Condition.query_terms provided are combined with OR operator. * Action Input: The request query and filter that are applied to the retrieved products, in addition to any filters already provided with the SearchRequest. The AND operator is used to combine the query&#x27;s existing filters with the filter rule(s). NOTE: May result in 0 results when filters conflict. * Action Result: Filters the returned objects to be ONLY those that passed the filter. # Filters results.
      &quot;filter&quot;: &quot;A String&quot;, # A filter to apply on the matching condition results. Supported features: * filter must be set. * Filter syntax is identical to SearchRequest.filter. For more information, see [Filter](/retail/docs/filter-and-order#filter). * To filter products with product ID &quot;product_1&quot; or &quot;product_2&quot;, and color &quot;Red&quot; or &quot;Blue&quot;: *(id: ANY(&quot;product_1&quot;, &quot;product_2&quot;)) * *AND * *(colorFamilies: ANY(&quot;Red&quot;, &quot;Blue&quot;)) *
    },
    &quot;forceReturnFacetAction&quot;: { # Force returns an attribute/facet in the request around a certain position or above. * Rule Condition: Must specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for browse only), but can&#x27;t specify both. * Action Inputs: attribute name, position * Action Result: Will force return a facet key around a certain position or above if the condition is satisfied. Example: Suppose the query is &quot;shoes&quot;, the Condition.query_terms is &quot;shoes&quot;, the ForceReturnFacetAction.FacetPositionAdjustment.attribute_name is &quot;size&quot; and the ForceReturnFacetAction.FacetPositionAdjustment.position is 8. Two cases: a) The facet key &quot;size&quot; is not already in the top 8 slots, then the facet &quot;size&quot; will appear at a position close to 8. b) The facet key &quot;size&quot; in among the top 8 positions in the request, then it will stay at its current rank. # Force returns an attribute as a facet in the request.
      &quot;facetPositionAdjustments&quot;: [ # Each instance corresponds to a force return attribute for the given condition. There can&#x27;t be more 15 instances here.
        { # Each facet position adjustment consists of a single attribute name (i.e. facet key) along with a specified position.
          &quot;attributeName&quot;: &quot;A String&quot;, # The attribute name to force return as a facet. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters long.
          &quot;position&quot;: 42, # This is the position in the request as explained above. It should be strictly positive be at most 100.
        },
      ],
    },
    &quot;ignoreAction&quot;: { # Prevents a term in the query from being used in search. Example: Don&#x27;t search for &quot;shoddy&quot;. # Ignores specific terms from query during search.
      &quot;ignoreTerms&quot;: [ # Terms to ignore in the search query.
        &quot;A String&quot;,
      ],
    },
    &quot;onewaySynonymsAction&quot;: { # Maps a set of terms to a set of synonyms. Set of synonyms will be treated as synonyms of each query term only. `query_terms` will not be treated as synonyms of each other. Example: &quot;sneakers&quot; will use a synonym of &quot;shoes&quot;. &quot;shoes&quot; will not use a synonym of &quot;sneakers&quot;. # Treats specific term as a synonym with a group of terms. Group of terms will not be treated as synonyms with the specific term.
      &quot;onewayTerms&quot;: [ # Will be [deprecated = true] post migration;
        &quot;A String&quot;,
      ],
      &quot;queryTerms&quot;: [ # Terms from the search query. Will treat synonyms as their synonyms. Not themselves synonyms of the synonyms. Can specify up to 100 terms.
        &quot;A String&quot;,
      ],
      &quot;synonyms&quot;: [ # Defines a set of synonyms. Cannot contain duplicates. Can specify up to 100 synonyms.
        &quot;A String&quot;,
      ],
    },
    &quot;pinAction&quot;: { # Pins one or more specified products to a specific position in the results. * Rule Condition: Must specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for browse only), but can&#x27;t specify both. * Action Input: mapping of `[pin_position, product_id]` pairs (pin position uses 1-based indexing). * Action Result: Will pin products with matching ids to the position specified in the final result order. Example: Suppose the query is `shoes`, the Condition.query_terms is `shoes` and the pin_map has `{1, &quot;pid1&quot;}`, then product with `pid1` will be pinned to the top position in the final results. If multiple PinActions are matched to a single request the actions will be processed from most to least recently updated. Pins to positions larger than the max allowed page size of 120 are not allowed. # Pins one or more specified products to a specific position in the results.
      &quot;pinMap&quot;: { # Required. A map of positions to product_ids. Partial matches per action are allowed, if a certain position in the map is already filled that `[position, product_id]` pair will be ignored but the rest may still be applied. This case will only occur if multiple pin actions are matched to a single request, as the map guarantees that pin positions are unique within the same action. Duplicate product_ids are not permitted within a single pin map. The max size of this map is 120, equivalent to the max [request page size](https://cloud.google.com/retail/docs/reference/rest/v2/projects.locations.catalogs.placements/search#request-body).
        &quot;a_key&quot;: &quot;A String&quot;,
      },
    },
    &quot;redirectAction&quot;: { # Redirects a shopper to a specific page. * Rule Condition: Must specify Condition.query_terms. * Action Input: Request Query * Action Result: Redirects shopper to provided uri. # Redirects a shopper to a specific page.
      &quot;redirectUri&quot;: &quot;A String&quot;, # URL must have length equal or less than 2000 characters.
    },
    &quot;removeFacetAction&quot;: { # Removes an attribute/facet in the request if is present. * Rule Condition: Must specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for browse only), but can&#x27;t specify both. * Action Input: attribute name * Action Result: Will remove the attribute (as a facet) from the request if it is present. Example: Suppose the query is &quot;shoes&quot;, the Condition.query_terms is &quot;shoes&quot; and the attribute name &quot;size&quot;, then facet key &quot;size&quot; will be removed from the request (if it is present). # Remove an attribute as a facet in the request (if present).
      &quot;attributeNames&quot;: [ # The attribute names (i.e. facet keys) to remove from the dynamic facets (if present in the request). There can&#x27;t be more 3 attribute names. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters.
        &quot;A String&quot;,
      ],
    },
    &quot;replacementAction&quot;: { # Replaces a term in the query. Multiple replacement candidates can be specified. All `query_terms` will be replaced with the replacement term. Example: Replace &quot;gShoe&quot; with &quot;google shoe&quot;. # Replaces specific terms in the query.
      &quot;queryTerms&quot;: [ # Terms from the search query. Will be replaced by replacement term. Can specify up to 100 terms.
        &quot;A String&quot;,
      ],
      &quot;replacementTerm&quot;: &quot;A String&quot;, # Term that will be used for replacement.
      &quot;term&quot;: &quot;A String&quot;, # Will be [deprecated = true] post migration;
    },
    &quot;twowaySynonymsAction&quot;: { # Creates a set of terms that will be treated as synonyms of each other. Example: synonyms of &quot;sneakers&quot; and &quot;shoes&quot;: * &quot;sneakers&quot; will use a synonym of &quot;shoes&quot;. * &quot;shoes&quot; will use a synonym of &quot;sneakers&quot;. # Treats a set of terms as synonyms of one another.
      &quot;synonyms&quot;: [ # Defines a set of synonyms. Can specify up to 100 synonyms. Must specify at least 2 synonyms.
        &quot;A String&quot;,
      ],
    },
  },
  &quot;searchSolutionUseCase&quot;: [ # Specifies the use case for the control. Affects what condition fields can be set. Only settable by search controls. Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified. Currently only allow one search_solution_use_case per control.
    &quot;A String&quot;,
  ],
  &quot;solutionTypes&quot;: [ # Required. Immutable. The solution types that the control is used for. Currently we support setting only one type of solution at creation time. Only `SOLUTION_TYPE_SEARCH` value is supported at the moment. If no solution type is provided at creation time, will default to SOLUTION_TYPE_SEARCH.
    &quot;A String&quot;,
  ],
}

  controlId: string, Required. The ID to use for the Control, which will become the final component of the Control&#x27;s resource name. This value should be 4-63 characters, and valid characters are /a-z-_/.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Configures dynamic metadata that can be linked to a ServingConfig and affect search or recommendation results at serving time.
  &quot;associatedServingConfigIds&quot;: [ # Output only. List of serving config ids that are associated with this control in the same Catalog. Note the association is managed via the ServingConfig, this is an output only denormalized view.
    &quot;A String&quot;,
  ],
  &quot;displayName&quot;: &quot;A String&quot;, # Required. The human readable control display name. Used in Retail UI. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is thrown.
  &quot;name&quot;: &quot;A String&quot;, # Immutable. Fully qualified name `projects/*/locations/global/catalogs/*/controls/*`
  &quot;rule&quot;: { # A rule is a condition-action pair * A condition defines when a rule is to be triggered. * An action specifies what occurs on that trigger. Currently rules only work for controls with SOLUTION_TYPE_SEARCH. # A rule control - a condition-action pair. Enacts a set action when the condition is triggered. For example: Boost &quot;gShoe&quot; when query full matches &quot;Running Shoes&quot;.
    &quot;boostAction&quot;: { # A boost action to apply to results matching condition specified above. # A boost action.
      &quot;boost&quot;: 3.14, # Strength of the condition boost, which must be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the item a big promotion. However, it does not necessarily mean that the boosted item will be the top result at all times, nor that other items will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant items. Setting to -1.0 gives the item a big demotion. However, results that are deeply relevant might still be shown. The item will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored.
      &quot;productsFilter&quot;: &quot;A String&quot;, # The filter can have a max size of 5000 characters. An expression which specifies which products to apply an action to. The syntax and supported fields are the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Examples: * To boost products with product ID &quot;product_1&quot; or &quot;product_2&quot;, and color &quot;Red&quot; or &quot;Blue&quot;: *(id: ANY(&quot;product_1&quot;, &quot;product_2&quot;)) * *AND * *(colorFamilies: ANY(&quot;Red&quot;, &quot;Blue&quot;)) *
    },
    &quot;condition&quot;: { # Metadata that is used to define a condition that triggers an action. A valid condition must specify at least one of &#x27;query_terms&#x27; or &#x27;products_filter&#x27;. If multiple fields are specified, the condition is met if all the fields are satisfied e.g. if a set of query terms and product_filter are set, then only items matching the product_filter for requests with a query matching the query terms wil get boosted. # Required. The condition that triggers the rule. If the condition is empty, the rule will always apply.
      &quot;activeTimeRange&quot;: [ # Range of time(s) specifying when Condition is active. Condition true if any time range matches.
        { # Used for time-dependent conditions. Example: Want to have rule applied for week long sale.
          &quot;endTime&quot;: &quot;A String&quot;, # End of time range. Range is inclusive.
          &quot;startTime&quot;: &quot;A String&quot;, # Start of time range. Range is inclusive.
        },
      ],
      &quot;pageCategories&quot;: [ # Used to support browse uses cases. A list (up to 10 entries) of categories or departments. The format should be the same as UserEvent.page_categories;
        &quot;A String&quot;,
      ],
      &quot;queryTerms&quot;: [ # A list (up to 10 entries) of terms to match the query on. If not specified, match all queries. If many query terms are specified, the condition is matched if any of the terms is a match (i.e. using the OR operator).
        { # Query terms that we want to match on.
          &quot;fullMatch&quot;: True or False, # Whether this is supposed to be a full or partial match.
          &quot;value&quot;: &quot;A String&quot;, # The value of the term to match on. Value cannot be empty. Value can have at most 3 terms if specified as a partial match. Each space separated string is considered as one term. For example, &quot;a b c&quot; is 3 terms and allowed, but &quot; a b c d&quot; is 4 terms and not allowed for a partial match.
        },
      ],
    },
    &quot;doNotAssociateAction&quot;: { # Prevents `query_term` from being associated with specified terms during search. Example: Don&#x27;t associate &quot;gShoe&quot; and &quot;cheap&quot;. # Prevents term from being associated with other terms.
      &quot;doNotAssociateTerms&quot;: [ # Cannot contain duplicates or the query term. Can specify up to 100 terms.
        &quot;A String&quot;,
      ],
      &quot;queryTerms&quot;: [ # Terms from the search query. Will not consider do_not_associate_terms for search if in search query. Can specify up to 100 terms.
        &quot;A String&quot;,
      ],
      &quot;terms&quot;: [ # Will be [deprecated = true] post migration;
        &quot;A String&quot;,
      ],
    },
    &quot;filterAction&quot;: { # * Rule Condition: - No Condition.query_terms provided is a global match. - 1 or more Condition.query_terms provided are combined with OR operator. * Action Input: The request query and filter that are applied to the retrieved products, in addition to any filters already provided with the SearchRequest. The AND operator is used to combine the query&#x27;s existing filters with the filter rule(s). NOTE: May result in 0 results when filters conflict. * Action Result: Filters the returned objects to be ONLY those that passed the filter. # Filters results.
      &quot;filter&quot;: &quot;A String&quot;, # A filter to apply on the matching condition results. Supported features: * filter must be set. * Filter syntax is identical to SearchRequest.filter. For more information, see [Filter](/retail/docs/filter-and-order#filter). * To filter products with product ID &quot;product_1&quot; or &quot;product_2&quot;, and color &quot;Red&quot; or &quot;Blue&quot;: *(id: ANY(&quot;product_1&quot;, &quot;product_2&quot;)) * *AND * *(colorFamilies: ANY(&quot;Red&quot;, &quot;Blue&quot;)) *
    },
    &quot;forceReturnFacetAction&quot;: { # Force returns an attribute/facet in the request around a certain position or above. * Rule Condition: Must specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for browse only), but can&#x27;t specify both. * Action Inputs: attribute name, position * Action Result: Will force return a facet key around a certain position or above if the condition is satisfied. Example: Suppose the query is &quot;shoes&quot;, the Condition.query_terms is &quot;shoes&quot;, the ForceReturnFacetAction.FacetPositionAdjustment.attribute_name is &quot;size&quot; and the ForceReturnFacetAction.FacetPositionAdjustment.position is 8. Two cases: a) The facet key &quot;size&quot; is not already in the top 8 slots, then the facet &quot;size&quot; will appear at a position close to 8. b) The facet key &quot;size&quot; in among the top 8 positions in the request, then it will stay at its current rank. # Force returns an attribute as a facet in the request.
      &quot;facetPositionAdjustments&quot;: [ # Each instance corresponds to a force return attribute for the given condition. There can&#x27;t be more 15 instances here.
        { # Each facet position adjustment consists of a single attribute name (i.e. facet key) along with a specified position.
          &quot;attributeName&quot;: &quot;A String&quot;, # The attribute name to force return as a facet. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters long.
          &quot;position&quot;: 42, # This is the position in the request as explained above. It should be strictly positive be at most 100.
        },
      ],
    },
    &quot;ignoreAction&quot;: { # Prevents a term in the query from being used in search. Example: Don&#x27;t search for &quot;shoddy&quot;. # Ignores specific terms from query during search.
      &quot;ignoreTerms&quot;: [ # Terms to ignore in the search query.
        &quot;A String&quot;,
      ],
    },
    &quot;onewaySynonymsAction&quot;: { # Maps a set of terms to a set of synonyms. Set of synonyms will be treated as synonyms of each query term only. `query_terms` will not be treated as synonyms of each other. Example: &quot;sneakers&quot; will use a synonym of &quot;shoes&quot;. &quot;shoes&quot; will not use a synonym of &quot;sneakers&quot;. # Treats specific term as a synonym with a group of terms. Group of terms will not be treated as synonyms with the specific term.
      &quot;onewayTerms&quot;: [ # Will be [deprecated = true] post migration;
        &quot;A String&quot;,
      ],
      &quot;queryTerms&quot;: [ # Terms from the search query. Will treat synonyms as their synonyms. Not themselves synonyms of the synonyms. Can specify up to 100 terms.
        &quot;A String&quot;,
      ],
      &quot;synonyms&quot;: [ # Defines a set of synonyms. Cannot contain duplicates. Can specify up to 100 synonyms.
        &quot;A String&quot;,
      ],
    },
    &quot;pinAction&quot;: { # Pins one or more specified products to a specific position in the results. * Rule Condition: Must specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for browse only), but can&#x27;t specify both. * Action Input: mapping of `[pin_position, product_id]` pairs (pin position uses 1-based indexing). * Action Result: Will pin products with matching ids to the position specified in the final result order. Example: Suppose the query is `shoes`, the Condition.query_terms is `shoes` and the pin_map has `{1, &quot;pid1&quot;}`, then product with `pid1` will be pinned to the top position in the final results. If multiple PinActions are matched to a single request the actions will be processed from most to least recently updated. Pins to positions larger than the max allowed page size of 120 are not allowed. # Pins one or more specified products to a specific position in the results.
      &quot;pinMap&quot;: { # Required. A map of positions to product_ids. Partial matches per action are allowed, if a certain position in the map is already filled that `[position, product_id]` pair will be ignored but the rest may still be applied. This case will only occur if multiple pin actions are matched to a single request, as the map guarantees that pin positions are unique within the same action. Duplicate product_ids are not permitted within a single pin map. The max size of this map is 120, equivalent to the max [request page size](https://cloud.google.com/retail/docs/reference/rest/v2/projects.locations.catalogs.placements/search#request-body).
        &quot;a_key&quot;: &quot;A String&quot;,
      },
    },
    &quot;redirectAction&quot;: { # Redirects a shopper to a specific page. * Rule Condition: Must specify Condition.query_terms. * Action Input: Request Query * Action Result: Redirects shopper to provided uri. # Redirects a shopper to a specific page.
      &quot;redirectUri&quot;: &quot;A String&quot;, # URL must have length equal or less than 2000 characters.
    },
    &quot;removeFacetAction&quot;: { # Removes an attribute/facet in the request if is present. * Rule Condition: Must specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for browse only), but can&#x27;t specify both. * Action Input: attribute name * Action Result: Will remove the attribute (as a facet) from the request if it is present. Example: Suppose the query is &quot;shoes&quot;, the Condition.query_terms is &quot;shoes&quot; and the attribute name &quot;size&quot;, then facet key &quot;size&quot; will be removed from the request (if it is present). # Remove an attribute as a facet in the request (if present).
      &quot;attributeNames&quot;: [ # The attribute names (i.e. facet keys) to remove from the dynamic facets (if present in the request). There can&#x27;t be more 3 attribute names. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters.
        &quot;A String&quot;,
      ],
    },
    &quot;replacementAction&quot;: { # Replaces a term in the query. Multiple replacement candidates can be specified. All `query_terms` will be replaced with the replacement term. Example: Replace &quot;gShoe&quot; with &quot;google shoe&quot;. # Replaces specific terms in the query.
      &quot;queryTerms&quot;: [ # Terms from the search query. Will be replaced by replacement term. Can specify up to 100 terms.
        &quot;A String&quot;,
      ],
      &quot;replacementTerm&quot;: &quot;A String&quot;, # Term that will be used for replacement.
      &quot;term&quot;: &quot;A String&quot;, # Will be [deprecated = true] post migration;
    },
    &quot;twowaySynonymsAction&quot;: { # Creates a set of terms that will be treated as synonyms of each other. Example: synonyms of &quot;sneakers&quot; and &quot;shoes&quot;: * &quot;sneakers&quot; will use a synonym of &quot;shoes&quot;. * &quot;shoes&quot; will use a synonym of &quot;sneakers&quot;. # Treats a set of terms as synonyms of one another.
      &quot;synonyms&quot;: [ # Defines a set of synonyms. Can specify up to 100 synonyms. Must specify at least 2 synonyms.
        &quot;A String&quot;,
      ],
    },
  },
  &quot;searchSolutionUseCase&quot;: [ # Specifies the use case for the control. Affects what condition fields can be set. Only settable by search controls. Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified. Currently only allow one search_solution_use_case per control.
    &quot;A String&quot;,
  ],
  &quot;solutionTypes&quot;: [ # Required. Immutable. The solution types that the control is used for. Currently we support setting only one type of solution at creation time. Only `SOLUTION_TYPE_SEARCH` value is supported at the moment. If no solution type is provided at creation time, will default to SOLUTION_TYPE_SEARCH.
    &quot;A String&quot;,
  ],
}</pre>
</div>

<div class="method">
    <code class="details" id="delete">delete(name, x__xgafv=None)</code>
  <pre>Deletes a Control. If the Control to delete does not exist, a NOT_FOUND error is returned.

Args:
  name: string, Required. The resource name of the Control to delete. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/controls/{control_id}` (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
}</pre>
</div>

<div class="method">
    <code class="details" id="get">get(name, x__xgafv=None)</code>
  <pre>Gets a Control.

Args:
  name: string, Required. The resource name of the Control to get. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}/controls/{control_id}` (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Configures dynamic metadata that can be linked to a ServingConfig and affect search or recommendation results at serving time.
  &quot;associatedServingConfigIds&quot;: [ # Output only. List of serving config ids that are associated with this control in the same Catalog. Note the association is managed via the ServingConfig, this is an output only denormalized view.
    &quot;A String&quot;,
  ],
  &quot;displayName&quot;: &quot;A String&quot;, # Required. The human readable control display name. Used in Retail UI. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is thrown.
  &quot;name&quot;: &quot;A String&quot;, # Immutable. Fully qualified name `projects/*/locations/global/catalogs/*/controls/*`
  &quot;rule&quot;: { # A rule is a condition-action pair * A condition defines when a rule is to be triggered. * An action specifies what occurs on that trigger. Currently rules only work for controls with SOLUTION_TYPE_SEARCH. # A rule control - a condition-action pair. Enacts a set action when the condition is triggered. For example: Boost &quot;gShoe&quot; when query full matches &quot;Running Shoes&quot;.
    &quot;boostAction&quot;: { # A boost action to apply to results matching condition specified above. # A boost action.
      &quot;boost&quot;: 3.14, # Strength of the condition boost, which must be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the item a big promotion. However, it does not necessarily mean that the boosted item will be the top result at all times, nor that other items will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant items. Setting to -1.0 gives the item a big demotion. However, results that are deeply relevant might still be shown. The item will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored.
      &quot;productsFilter&quot;: &quot;A String&quot;, # The filter can have a max size of 5000 characters. An expression which specifies which products to apply an action to. The syntax and supported fields are the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Examples: * To boost products with product ID &quot;product_1&quot; or &quot;product_2&quot;, and color &quot;Red&quot; or &quot;Blue&quot;: *(id: ANY(&quot;product_1&quot;, &quot;product_2&quot;)) * *AND * *(colorFamilies: ANY(&quot;Red&quot;, &quot;Blue&quot;)) *
    },
    &quot;condition&quot;: { # Metadata that is used to define a condition that triggers an action. A valid condition must specify at least one of &#x27;query_terms&#x27; or &#x27;products_filter&#x27;. If multiple fields are specified, the condition is met if all the fields are satisfied e.g. if a set of query terms and product_filter are set, then only items matching the product_filter for requests with a query matching the query terms wil get boosted. # Required. The condition that triggers the rule. If the condition is empty, the rule will always apply.
      &quot;activeTimeRange&quot;: [ # Range of time(s) specifying when Condition is active. Condition true if any time range matches.
        { # Used for time-dependent conditions. Example: Want to have rule applied for week long sale.
          &quot;endTime&quot;: &quot;A String&quot;, # End of time range. Range is inclusive.
          &quot;startTime&quot;: &quot;A String&quot;, # Start of time range. Range is inclusive.
        },
      ],
      &quot;pageCategories&quot;: [ # Used to support browse uses cases. A list (up to 10 entries) of categories or departments. The format should be the same as UserEvent.page_categories;
        &quot;A String&quot;,
      ],
      &quot;queryTerms&quot;: [ # A list (up to 10 entries) of terms to match the query on. If not specified, match all queries. If many query terms are specified, the condition is matched if any of the terms is a match (i.e. using the OR operator).
        { # Query terms that we want to match on.
          &quot;fullMatch&quot;: True or False, # Whether this is supposed to be a full or partial match.
          &quot;value&quot;: &quot;A String&quot;, # The value of the term to match on. Value cannot be empty. Value can have at most 3 terms if specified as a partial match. Each space separated string is considered as one term. For example, &quot;a b c&quot; is 3 terms and allowed, but &quot; a b c d&quot; is 4 terms and not allowed for a partial match.
        },
      ],
    },
    &quot;doNotAssociateAction&quot;: { # Prevents `query_term` from being associated with specified terms during search. Example: Don&#x27;t associate &quot;gShoe&quot; and &quot;cheap&quot;. # Prevents term from being associated with other terms.
      &quot;doNotAssociateTerms&quot;: [ # Cannot contain duplicates or the query term. Can specify up to 100 terms.
        &quot;A String&quot;,
      ],
      &quot;queryTerms&quot;: [ # Terms from the search query. Will not consider do_not_associate_terms for search if in search query. Can specify up to 100 terms.
        &quot;A String&quot;,
      ],
      &quot;terms&quot;: [ # Will be [deprecated = true] post migration;
        &quot;A String&quot;,
      ],
    },
    &quot;filterAction&quot;: { # * Rule Condition: - No Condition.query_terms provided is a global match. - 1 or more Condition.query_terms provided are combined with OR operator. * Action Input: The request query and filter that are applied to the retrieved products, in addition to any filters already provided with the SearchRequest. The AND operator is used to combine the query&#x27;s existing filters with the filter rule(s). NOTE: May result in 0 results when filters conflict. * Action Result: Filters the returned objects to be ONLY those that passed the filter. # Filters results.
      &quot;filter&quot;: &quot;A String&quot;, # A filter to apply on the matching condition results. Supported features: * filter must be set. * Filter syntax is identical to SearchRequest.filter. For more information, see [Filter](/retail/docs/filter-and-order#filter). * To filter products with product ID &quot;product_1&quot; or &quot;product_2&quot;, and color &quot;Red&quot; or &quot;Blue&quot;: *(id: ANY(&quot;product_1&quot;, &quot;product_2&quot;)) * *AND * *(colorFamilies: ANY(&quot;Red&quot;, &quot;Blue&quot;)) *
    },
    &quot;forceReturnFacetAction&quot;: { # Force returns an attribute/facet in the request around a certain position or above. * Rule Condition: Must specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for browse only), but can&#x27;t specify both. * Action Inputs: attribute name, position * Action Result: Will force return a facet key around a certain position or above if the condition is satisfied. Example: Suppose the query is &quot;shoes&quot;, the Condition.query_terms is &quot;shoes&quot;, the ForceReturnFacetAction.FacetPositionAdjustment.attribute_name is &quot;size&quot; and the ForceReturnFacetAction.FacetPositionAdjustment.position is 8. Two cases: a) The facet key &quot;size&quot; is not already in the top 8 slots, then the facet &quot;size&quot; will appear at a position close to 8. b) The facet key &quot;size&quot; in among the top 8 positions in the request, then it will stay at its current rank. # Force returns an attribute as a facet in the request.
      &quot;facetPositionAdjustments&quot;: [ # Each instance corresponds to a force return attribute for the given condition. There can&#x27;t be more 15 instances here.
        { # Each facet position adjustment consists of a single attribute name (i.e. facet key) along with a specified position.
          &quot;attributeName&quot;: &quot;A String&quot;, # The attribute name to force return as a facet. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters long.
          &quot;position&quot;: 42, # This is the position in the request as explained above. It should be strictly positive be at most 100.
        },
      ],
    },
    &quot;ignoreAction&quot;: { # Prevents a term in the query from being used in search. Example: Don&#x27;t search for &quot;shoddy&quot;. # Ignores specific terms from query during search.
      &quot;ignoreTerms&quot;: [ # Terms to ignore in the search query.
        &quot;A String&quot;,
      ],
    },
    &quot;onewaySynonymsAction&quot;: { # Maps a set of terms to a set of synonyms. Set of synonyms will be treated as synonyms of each query term only. `query_terms` will not be treated as synonyms of each other. Example: &quot;sneakers&quot; will use a synonym of &quot;shoes&quot;. &quot;shoes&quot; will not use a synonym of &quot;sneakers&quot;. # Treats specific term as a synonym with a group of terms. Group of terms will not be treated as synonyms with the specific term.
      &quot;onewayTerms&quot;: [ # Will be [deprecated = true] post migration;
        &quot;A String&quot;,
      ],
      &quot;queryTerms&quot;: [ # Terms from the search query. Will treat synonyms as their synonyms. Not themselves synonyms of the synonyms. Can specify up to 100 terms.
        &quot;A String&quot;,
      ],
      &quot;synonyms&quot;: [ # Defines a set of synonyms. Cannot contain duplicates. Can specify up to 100 synonyms.
        &quot;A String&quot;,
      ],
    },
    &quot;pinAction&quot;: { # Pins one or more specified products to a specific position in the results. * Rule Condition: Must specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for browse only), but can&#x27;t specify both. * Action Input: mapping of `[pin_position, product_id]` pairs (pin position uses 1-based indexing). * Action Result: Will pin products with matching ids to the position specified in the final result order. Example: Suppose the query is `shoes`, the Condition.query_terms is `shoes` and the pin_map has `{1, &quot;pid1&quot;}`, then product with `pid1` will be pinned to the top position in the final results. If multiple PinActions are matched to a single request the actions will be processed from most to least recently updated. Pins to positions larger than the max allowed page size of 120 are not allowed. # Pins one or more specified products to a specific position in the results.
      &quot;pinMap&quot;: { # Required. A map of positions to product_ids. Partial matches per action are allowed, if a certain position in the map is already filled that `[position, product_id]` pair will be ignored but the rest may still be applied. This case will only occur if multiple pin actions are matched to a single request, as the map guarantees that pin positions are unique within the same action. Duplicate product_ids are not permitted within a single pin map. The max size of this map is 120, equivalent to the max [request page size](https://cloud.google.com/retail/docs/reference/rest/v2/projects.locations.catalogs.placements/search#request-body).
        &quot;a_key&quot;: &quot;A String&quot;,
      },
    },
    &quot;redirectAction&quot;: { # Redirects a shopper to a specific page. * Rule Condition: Must specify Condition.query_terms. * Action Input: Request Query * Action Result: Redirects shopper to provided uri. # Redirects a shopper to a specific page.
      &quot;redirectUri&quot;: &quot;A String&quot;, # URL must have length equal or less than 2000 characters.
    },
    &quot;removeFacetAction&quot;: { # Removes an attribute/facet in the request if is present. * Rule Condition: Must specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for browse only), but can&#x27;t specify both. * Action Input: attribute name * Action Result: Will remove the attribute (as a facet) from the request if it is present. Example: Suppose the query is &quot;shoes&quot;, the Condition.query_terms is &quot;shoes&quot; and the attribute name &quot;size&quot;, then facet key &quot;size&quot; will be removed from the request (if it is present). # Remove an attribute as a facet in the request (if present).
      &quot;attributeNames&quot;: [ # The attribute names (i.e. facet keys) to remove from the dynamic facets (if present in the request). There can&#x27;t be more 3 attribute names. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters.
        &quot;A String&quot;,
      ],
    },
    &quot;replacementAction&quot;: { # Replaces a term in the query. Multiple replacement candidates can be specified. All `query_terms` will be replaced with the replacement term. Example: Replace &quot;gShoe&quot; with &quot;google shoe&quot;. # Replaces specific terms in the query.
      &quot;queryTerms&quot;: [ # Terms from the search query. Will be replaced by replacement term. Can specify up to 100 terms.
        &quot;A String&quot;,
      ],
      &quot;replacementTerm&quot;: &quot;A String&quot;, # Term that will be used for replacement.
      &quot;term&quot;: &quot;A String&quot;, # Will be [deprecated = true] post migration;
    },
    &quot;twowaySynonymsAction&quot;: { # Creates a set of terms that will be treated as synonyms of each other. Example: synonyms of &quot;sneakers&quot; and &quot;shoes&quot;: * &quot;sneakers&quot; will use a synonym of &quot;shoes&quot;. * &quot;shoes&quot; will use a synonym of &quot;sneakers&quot;. # Treats a set of terms as synonyms of one another.
      &quot;synonyms&quot;: [ # Defines a set of synonyms. Can specify up to 100 synonyms. Must specify at least 2 synonyms.
        &quot;A String&quot;,
      ],
    },
  },
  &quot;searchSolutionUseCase&quot;: [ # Specifies the use case for the control. Affects what condition fields can be set. Only settable by search controls. Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified. Currently only allow one search_solution_use_case per control.
    &quot;A String&quot;,
  ],
  &quot;solutionTypes&quot;: [ # Required. Immutable. The solution types that the control is used for. Currently we support setting only one type of solution at creation time. Only `SOLUTION_TYPE_SEARCH` value is supported at the moment. If no solution type is provided at creation time, will default to SOLUTION_TYPE_SEARCH.
    &quot;A String&quot;,
  ],
}</pre>
</div>

<div class="method">
    <code class="details" id="list">list(parent, filter=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
  <pre>Lists all Controls by their parent Catalog.

Args:
  parent: string, Required. The catalog resource name. Format: `projects/{project_number}/locations/{location_id}/catalogs/{catalog_id}` (required)
  filter: string, Optional. A filter to apply on the list results. Supported features: * List all the products under the parent branch if filter is unset. * List controls that are used in a single ServingConfig: &#x27;serving_config = &quot;boosted_home_page_cvr&quot;&#x27;
  pageSize: integer, Optional. Maximum number of results to return. If unspecified, defaults to 50. Max allowed value is 1000.
  pageToken: string, Optional. A page token, received from a previous `ListControls` call. Provide this to retrieve the subsequent page.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response for ListControls method.
  &quot;controls&quot;: [ # All the Controls for a given catalog.
    { # Configures dynamic metadata that can be linked to a ServingConfig and affect search or recommendation results at serving time.
      &quot;associatedServingConfigIds&quot;: [ # Output only. List of serving config ids that are associated with this control in the same Catalog. Note the association is managed via the ServingConfig, this is an output only denormalized view.
        &quot;A String&quot;,
      ],
      &quot;displayName&quot;: &quot;A String&quot;, # Required. The human readable control display name. Used in Retail UI. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is thrown.
      &quot;name&quot;: &quot;A String&quot;, # Immutable. Fully qualified name `projects/*/locations/global/catalogs/*/controls/*`
      &quot;rule&quot;: { # A rule is a condition-action pair * A condition defines when a rule is to be triggered. * An action specifies what occurs on that trigger. Currently rules only work for controls with SOLUTION_TYPE_SEARCH. # A rule control - a condition-action pair. Enacts a set action when the condition is triggered. For example: Boost &quot;gShoe&quot; when query full matches &quot;Running Shoes&quot;.
        &quot;boostAction&quot;: { # A boost action to apply to results matching condition specified above. # A boost action.
          &quot;boost&quot;: 3.14, # Strength of the condition boost, which must be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the item a big promotion. However, it does not necessarily mean that the boosted item will be the top result at all times, nor that other items will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant items. Setting to -1.0 gives the item a big demotion. However, results that are deeply relevant might still be shown. The item will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored.
          &quot;productsFilter&quot;: &quot;A String&quot;, # The filter can have a max size of 5000 characters. An expression which specifies which products to apply an action to. The syntax and supported fields are the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Examples: * To boost products with product ID &quot;product_1&quot; or &quot;product_2&quot;, and color &quot;Red&quot; or &quot;Blue&quot;: *(id: ANY(&quot;product_1&quot;, &quot;product_2&quot;)) * *AND * *(colorFamilies: ANY(&quot;Red&quot;, &quot;Blue&quot;)) *
        },
        &quot;condition&quot;: { # Metadata that is used to define a condition that triggers an action. A valid condition must specify at least one of &#x27;query_terms&#x27; or &#x27;products_filter&#x27;. If multiple fields are specified, the condition is met if all the fields are satisfied e.g. if a set of query terms and product_filter are set, then only items matching the product_filter for requests with a query matching the query terms wil get boosted. # Required. The condition that triggers the rule. If the condition is empty, the rule will always apply.
          &quot;activeTimeRange&quot;: [ # Range of time(s) specifying when Condition is active. Condition true if any time range matches.
            { # Used for time-dependent conditions. Example: Want to have rule applied for week long sale.
              &quot;endTime&quot;: &quot;A String&quot;, # End of time range. Range is inclusive.
              &quot;startTime&quot;: &quot;A String&quot;, # Start of time range. Range is inclusive.
            },
          ],
          &quot;pageCategories&quot;: [ # Used to support browse uses cases. A list (up to 10 entries) of categories or departments. The format should be the same as UserEvent.page_categories;
            &quot;A String&quot;,
          ],
          &quot;queryTerms&quot;: [ # A list (up to 10 entries) of terms to match the query on. If not specified, match all queries. If many query terms are specified, the condition is matched if any of the terms is a match (i.e. using the OR operator).
            { # Query terms that we want to match on.
              &quot;fullMatch&quot;: True or False, # Whether this is supposed to be a full or partial match.
              &quot;value&quot;: &quot;A String&quot;, # The value of the term to match on. Value cannot be empty. Value can have at most 3 terms if specified as a partial match. Each space separated string is considered as one term. For example, &quot;a b c&quot; is 3 terms and allowed, but &quot; a b c d&quot; is 4 terms and not allowed for a partial match.
            },
          ],
        },
        &quot;doNotAssociateAction&quot;: { # Prevents `query_term` from being associated with specified terms during search. Example: Don&#x27;t associate &quot;gShoe&quot; and &quot;cheap&quot;. # Prevents term from being associated with other terms.
          &quot;doNotAssociateTerms&quot;: [ # Cannot contain duplicates or the query term. Can specify up to 100 terms.
            &quot;A String&quot;,
          ],
          &quot;queryTerms&quot;: [ # Terms from the search query. Will not consider do_not_associate_terms for search if in search query. Can specify up to 100 terms.
            &quot;A String&quot;,
          ],
          &quot;terms&quot;: [ # Will be [deprecated = true] post migration;
            &quot;A String&quot;,
          ],
        },
        &quot;filterAction&quot;: { # * Rule Condition: - No Condition.query_terms provided is a global match. - 1 or more Condition.query_terms provided are combined with OR operator. * Action Input: The request query and filter that are applied to the retrieved products, in addition to any filters already provided with the SearchRequest. The AND operator is used to combine the query&#x27;s existing filters with the filter rule(s). NOTE: May result in 0 results when filters conflict. * Action Result: Filters the returned objects to be ONLY those that passed the filter. # Filters results.
          &quot;filter&quot;: &quot;A String&quot;, # A filter to apply on the matching condition results. Supported features: * filter must be set. * Filter syntax is identical to SearchRequest.filter. For more information, see [Filter](/retail/docs/filter-and-order#filter). * To filter products with product ID &quot;product_1&quot; or &quot;product_2&quot;, and color &quot;Red&quot; or &quot;Blue&quot;: *(id: ANY(&quot;product_1&quot;, &quot;product_2&quot;)) * *AND * *(colorFamilies: ANY(&quot;Red&quot;, &quot;Blue&quot;)) *
        },
        &quot;forceReturnFacetAction&quot;: { # Force returns an attribute/facet in the request around a certain position or above. * Rule Condition: Must specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for browse only), but can&#x27;t specify both. * Action Inputs: attribute name, position * Action Result: Will force return a facet key around a certain position or above if the condition is satisfied. Example: Suppose the query is &quot;shoes&quot;, the Condition.query_terms is &quot;shoes&quot;, the ForceReturnFacetAction.FacetPositionAdjustment.attribute_name is &quot;size&quot; and the ForceReturnFacetAction.FacetPositionAdjustment.position is 8. Two cases: a) The facet key &quot;size&quot; is not already in the top 8 slots, then the facet &quot;size&quot; will appear at a position close to 8. b) The facet key &quot;size&quot; in among the top 8 positions in the request, then it will stay at its current rank. # Force returns an attribute as a facet in the request.
          &quot;facetPositionAdjustments&quot;: [ # Each instance corresponds to a force return attribute for the given condition. There can&#x27;t be more 15 instances here.
            { # Each facet position adjustment consists of a single attribute name (i.e. facet key) along with a specified position.
              &quot;attributeName&quot;: &quot;A String&quot;, # The attribute name to force return as a facet. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters long.
              &quot;position&quot;: 42, # This is the position in the request as explained above. It should be strictly positive be at most 100.
            },
          ],
        },
        &quot;ignoreAction&quot;: { # Prevents a term in the query from being used in search. Example: Don&#x27;t search for &quot;shoddy&quot;. # Ignores specific terms from query during search.
          &quot;ignoreTerms&quot;: [ # Terms to ignore in the search query.
            &quot;A String&quot;,
          ],
        },
        &quot;onewaySynonymsAction&quot;: { # Maps a set of terms to a set of synonyms. Set of synonyms will be treated as synonyms of each query term only. `query_terms` will not be treated as synonyms of each other. Example: &quot;sneakers&quot; will use a synonym of &quot;shoes&quot;. &quot;shoes&quot; will not use a synonym of &quot;sneakers&quot;. # Treats specific term as a synonym with a group of terms. Group of terms will not be treated as synonyms with the specific term.
          &quot;onewayTerms&quot;: [ # Will be [deprecated = true] post migration;
            &quot;A String&quot;,
          ],
          &quot;queryTerms&quot;: [ # Terms from the search query. Will treat synonyms as their synonyms. Not themselves synonyms of the synonyms. Can specify up to 100 terms.
            &quot;A String&quot;,
          ],
          &quot;synonyms&quot;: [ # Defines a set of synonyms. Cannot contain duplicates. Can specify up to 100 synonyms.
            &quot;A String&quot;,
          ],
        },
        &quot;pinAction&quot;: { # Pins one or more specified products to a specific position in the results. * Rule Condition: Must specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for browse only), but can&#x27;t specify both. * Action Input: mapping of `[pin_position, product_id]` pairs (pin position uses 1-based indexing). * Action Result: Will pin products with matching ids to the position specified in the final result order. Example: Suppose the query is `shoes`, the Condition.query_terms is `shoes` and the pin_map has `{1, &quot;pid1&quot;}`, then product with `pid1` will be pinned to the top position in the final results. If multiple PinActions are matched to a single request the actions will be processed from most to least recently updated. Pins to positions larger than the max allowed page size of 120 are not allowed. # Pins one or more specified products to a specific position in the results.
          &quot;pinMap&quot;: { # Required. A map of positions to product_ids. Partial matches per action are allowed, if a certain position in the map is already filled that `[position, product_id]` pair will be ignored but the rest may still be applied. This case will only occur if multiple pin actions are matched to a single request, as the map guarantees that pin positions are unique within the same action. Duplicate product_ids are not permitted within a single pin map. The max size of this map is 120, equivalent to the max [request page size](https://cloud.google.com/retail/docs/reference/rest/v2/projects.locations.catalogs.placements/search#request-body).
            &quot;a_key&quot;: &quot;A String&quot;,
          },
        },
        &quot;redirectAction&quot;: { # Redirects a shopper to a specific page. * Rule Condition: Must specify Condition.query_terms. * Action Input: Request Query * Action Result: Redirects shopper to provided uri. # Redirects a shopper to a specific page.
          &quot;redirectUri&quot;: &quot;A String&quot;, # URL must have length equal or less than 2000 characters.
        },
        &quot;removeFacetAction&quot;: { # Removes an attribute/facet in the request if is present. * Rule Condition: Must specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for browse only), but can&#x27;t specify both. * Action Input: attribute name * Action Result: Will remove the attribute (as a facet) from the request if it is present. Example: Suppose the query is &quot;shoes&quot;, the Condition.query_terms is &quot;shoes&quot; and the attribute name &quot;size&quot;, then facet key &quot;size&quot; will be removed from the request (if it is present). # Remove an attribute as a facet in the request (if present).
          &quot;attributeNames&quot;: [ # The attribute names (i.e. facet keys) to remove from the dynamic facets (if present in the request). There can&#x27;t be more 3 attribute names. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters.
            &quot;A String&quot;,
          ],
        },
        &quot;replacementAction&quot;: { # Replaces a term in the query. Multiple replacement candidates can be specified. All `query_terms` will be replaced with the replacement term. Example: Replace &quot;gShoe&quot; with &quot;google shoe&quot;. # Replaces specific terms in the query.
          &quot;queryTerms&quot;: [ # Terms from the search query. Will be replaced by replacement term. Can specify up to 100 terms.
            &quot;A String&quot;,
          ],
          &quot;replacementTerm&quot;: &quot;A String&quot;, # Term that will be used for replacement.
          &quot;term&quot;: &quot;A String&quot;, # Will be [deprecated = true] post migration;
        },
        &quot;twowaySynonymsAction&quot;: { # Creates a set of terms that will be treated as synonyms of each other. Example: synonyms of &quot;sneakers&quot; and &quot;shoes&quot;: * &quot;sneakers&quot; will use a synonym of &quot;shoes&quot;. * &quot;shoes&quot; will use a synonym of &quot;sneakers&quot;. # Treats a set of terms as synonyms of one another.
          &quot;synonyms&quot;: [ # Defines a set of synonyms. Can specify up to 100 synonyms. Must specify at least 2 synonyms.
            &quot;A String&quot;,
          ],
        },
      },
      &quot;searchSolutionUseCase&quot;: [ # Specifies the use case for the control. Affects what condition fields can be set. Only settable by search controls. Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified. Currently only allow one search_solution_use_case per control.
        &quot;A String&quot;,
      ],
      &quot;solutionTypes&quot;: [ # Required. Immutable. The solution types that the control is used for. Currently we support setting only one type of solution at creation time. Only `SOLUTION_TYPE_SEARCH` value is supported at the moment. If no solution type is provided at creation time, will default to SOLUTION_TYPE_SEARCH.
        &quot;A String&quot;,
      ],
    },
  ],
  &quot;nextPageToken&quot;: &quot;A String&quot;, # Pagination token, if not returned indicates the last page.
}</pre>
</div>

<div class="method">
    <code class="details" id="list_next">list_next()</code>
  <pre>Retrieves the next page of results.

        Args:
          previous_request: The request for the previous page. (required)
          previous_response: The response from the request for the previous page. (required)

        Returns:
          A request object that you can call &#x27;execute()&#x27; on to request the next
          page. Returns None if there are no more items in the collection.
        </pre>
</div>

<div class="method">
    <code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code>
  <pre>Updates a Control. Control cannot be set to a different oneof field, if so an INVALID_ARGUMENT is returned. If the Control to update does not exist, a NOT_FOUND error is returned.

Args:
  name: string, Immutable. Fully qualified name `projects/*/locations/global/catalogs/*/controls/*` (required)
  body: object, The request body.
    The object takes the form of:

{ # Configures dynamic metadata that can be linked to a ServingConfig and affect search or recommendation results at serving time.
  &quot;associatedServingConfigIds&quot;: [ # Output only. List of serving config ids that are associated with this control in the same Catalog. Note the association is managed via the ServingConfig, this is an output only denormalized view.
    &quot;A String&quot;,
  ],
  &quot;displayName&quot;: &quot;A String&quot;, # Required. The human readable control display name. Used in Retail UI. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is thrown.
  &quot;name&quot;: &quot;A String&quot;, # Immutable. Fully qualified name `projects/*/locations/global/catalogs/*/controls/*`
  &quot;rule&quot;: { # A rule is a condition-action pair * A condition defines when a rule is to be triggered. * An action specifies what occurs on that trigger. Currently rules only work for controls with SOLUTION_TYPE_SEARCH. # A rule control - a condition-action pair. Enacts a set action when the condition is triggered. For example: Boost &quot;gShoe&quot; when query full matches &quot;Running Shoes&quot;.
    &quot;boostAction&quot;: { # A boost action to apply to results matching condition specified above. # A boost action.
      &quot;boost&quot;: 3.14, # Strength of the condition boost, which must be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the item a big promotion. However, it does not necessarily mean that the boosted item will be the top result at all times, nor that other items will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant items. Setting to -1.0 gives the item a big demotion. However, results that are deeply relevant might still be shown. The item will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored.
      &quot;productsFilter&quot;: &quot;A String&quot;, # The filter can have a max size of 5000 characters. An expression which specifies which products to apply an action to. The syntax and supported fields are the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Examples: * To boost products with product ID &quot;product_1&quot; or &quot;product_2&quot;, and color &quot;Red&quot; or &quot;Blue&quot;: *(id: ANY(&quot;product_1&quot;, &quot;product_2&quot;)) * *AND * *(colorFamilies: ANY(&quot;Red&quot;, &quot;Blue&quot;)) *
    },
    &quot;condition&quot;: { # Metadata that is used to define a condition that triggers an action. A valid condition must specify at least one of &#x27;query_terms&#x27; or &#x27;products_filter&#x27;. If multiple fields are specified, the condition is met if all the fields are satisfied e.g. if a set of query terms and product_filter are set, then only items matching the product_filter for requests with a query matching the query terms wil get boosted. # Required. The condition that triggers the rule. If the condition is empty, the rule will always apply.
      &quot;activeTimeRange&quot;: [ # Range of time(s) specifying when Condition is active. Condition true if any time range matches.
        { # Used for time-dependent conditions. Example: Want to have rule applied for week long sale.
          &quot;endTime&quot;: &quot;A String&quot;, # End of time range. Range is inclusive.
          &quot;startTime&quot;: &quot;A String&quot;, # Start of time range. Range is inclusive.
        },
      ],
      &quot;pageCategories&quot;: [ # Used to support browse uses cases. A list (up to 10 entries) of categories or departments. The format should be the same as UserEvent.page_categories;
        &quot;A String&quot;,
      ],
      &quot;queryTerms&quot;: [ # A list (up to 10 entries) of terms to match the query on. If not specified, match all queries. If many query terms are specified, the condition is matched if any of the terms is a match (i.e. using the OR operator).
        { # Query terms that we want to match on.
          &quot;fullMatch&quot;: True or False, # Whether this is supposed to be a full or partial match.
          &quot;value&quot;: &quot;A String&quot;, # The value of the term to match on. Value cannot be empty. Value can have at most 3 terms if specified as a partial match. Each space separated string is considered as one term. For example, &quot;a b c&quot; is 3 terms and allowed, but &quot; a b c d&quot; is 4 terms and not allowed for a partial match.
        },
      ],
    },
    &quot;doNotAssociateAction&quot;: { # Prevents `query_term` from being associated with specified terms during search. Example: Don&#x27;t associate &quot;gShoe&quot; and &quot;cheap&quot;. # Prevents term from being associated with other terms.
      &quot;doNotAssociateTerms&quot;: [ # Cannot contain duplicates or the query term. Can specify up to 100 terms.
        &quot;A String&quot;,
      ],
      &quot;queryTerms&quot;: [ # Terms from the search query. Will not consider do_not_associate_terms for search if in search query. Can specify up to 100 terms.
        &quot;A String&quot;,
      ],
      &quot;terms&quot;: [ # Will be [deprecated = true] post migration;
        &quot;A String&quot;,
      ],
    },
    &quot;filterAction&quot;: { # * Rule Condition: - No Condition.query_terms provided is a global match. - 1 or more Condition.query_terms provided are combined with OR operator. * Action Input: The request query and filter that are applied to the retrieved products, in addition to any filters already provided with the SearchRequest. The AND operator is used to combine the query&#x27;s existing filters with the filter rule(s). NOTE: May result in 0 results when filters conflict. * Action Result: Filters the returned objects to be ONLY those that passed the filter. # Filters results.
      &quot;filter&quot;: &quot;A String&quot;, # A filter to apply on the matching condition results. Supported features: * filter must be set. * Filter syntax is identical to SearchRequest.filter. For more information, see [Filter](/retail/docs/filter-and-order#filter). * To filter products with product ID &quot;product_1&quot; or &quot;product_2&quot;, and color &quot;Red&quot; or &quot;Blue&quot;: *(id: ANY(&quot;product_1&quot;, &quot;product_2&quot;)) * *AND * *(colorFamilies: ANY(&quot;Red&quot;, &quot;Blue&quot;)) *
    },
    &quot;forceReturnFacetAction&quot;: { # Force returns an attribute/facet in the request around a certain position or above. * Rule Condition: Must specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for browse only), but can&#x27;t specify both. * Action Inputs: attribute name, position * Action Result: Will force return a facet key around a certain position or above if the condition is satisfied. Example: Suppose the query is &quot;shoes&quot;, the Condition.query_terms is &quot;shoes&quot;, the ForceReturnFacetAction.FacetPositionAdjustment.attribute_name is &quot;size&quot; and the ForceReturnFacetAction.FacetPositionAdjustment.position is 8. Two cases: a) The facet key &quot;size&quot; is not already in the top 8 slots, then the facet &quot;size&quot; will appear at a position close to 8. b) The facet key &quot;size&quot; in among the top 8 positions in the request, then it will stay at its current rank. # Force returns an attribute as a facet in the request.
      &quot;facetPositionAdjustments&quot;: [ # Each instance corresponds to a force return attribute for the given condition. There can&#x27;t be more 15 instances here.
        { # Each facet position adjustment consists of a single attribute name (i.e. facet key) along with a specified position.
          &quot;attributeName&quot;: &quot;A String&quot;, # The attribute name to force return as a facet. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters long.
          &quot;position&quot;: 42, # This is the position in the request as explained above. It should be strictly positive be at most 100.
        },
      ],
    },
    &quot;ignoreAction&quot;: { # Prevents a term in the query from being used in search. Example: Don&#x27;t search for &quot;shoddy&quot;. # Ignores specific terms from query during search.
      &quot;ignoreTerms&quot;: [ # Terms to ignore in the search query.
        &quot;A String&quot;,
      ],
    },
    &quot;onewaySynonymsAction&quot;: { # Maps a set of terms to a set of synonyms. Set of synonyms will be treated as synonyms of each query term only. `query_terms` will not be treated as synonyms of each other. Example: &quot;sneakers&quot; will use a synonym of &quot;shoes&quot;. &quot;shoes&quot; will not use a synonym of &quot;sneakers&quot;. # Treats specific term as a synonym with a group of terms. Group of terms will not be treated as synonyms with the specific term.
      &quot;onewayTerms&quot;: [ # Will be [deprecated = true] post migration;
        &quot;A String&quot;,
      ],
      &quot;queryTerms&quot;: [ # Terms from the search query. Will treat synonyms as their synonyms. Not themselves synonyms of the synonyms. Can specify up to 100 terms.
        &quot;A String&quot;,
      ],
      &quot;synonyms&quot;: [ # Defines a set of synonyms. Cannot contain duplicates. Can specify up to 100 synonyms.
        &quot;A String&quot;,
      ],
    },
    &quot;pinAction&quot;: { # Pins one or more specified products to a specific position in the results. * Rule Condition: Must specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for browse only), but can&#x27;t specify both. * Action Input: mapping of `[pin_position, product_id]` pairs (pin position uses 1-based indexing). * Action Result: Will pin products with matching ids to the position specified in the final result order. Example: Suppose the query is `shoes`, the Condition.query_terms is `shoes` and the pin_map has `{1, &quot;pid1&quot;}`, then product with `pid1` will be pinned to the top position in the final results. If multiple PinActions are matched to a single request the actions will be processed from most to least recently updated. Pins to positions larger than the max allowed page size of 120 are not allowed. # Pins one or more specified products to a specific position in the results.
      &quot;pinMap&quot;: { # Required. A map of positions to product_ids. Partial matches per action are allowed, if a certain position in the map is already filled that `[position, product_id]` pair will be ignored but the rest may still be applied. This case will only occur if multiple pin actions are matched to a single request, as the map guarantees that pin positions are unique within the same action. Duplicate product_ids are not permitted within a single pin map. The max size of this map is 120, equivalent to the max [request page size](https://cloud.google.com/retail/docs/reference/rest/v2/projects.locations.catalogs.placements/search#request-body).
        &quot;a_key&quot;: &quot;A String&quot;,
      },
    },
    &quot;redirectAction&quot;: { # Redirects a shopper to a specific page. * Rule Condition: Must specify Condition.query_terms. * Action Input: Request Query * Action Result: Redirects shopper to provided uri. # Redirects a shopper to a specific page.
      &quot;redirectUri&quot;: &quot;A String&quot;, # URL must have length equal or less than 2000 characters.
    },
    &quot;removeFacetAction&quot;: { # Removes an attribute/facet in the request if is present. * Rule Condition: Must specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for browse only), but can&#x27;t specify both. * Action Input: attribute name * Action Result: Will remove the attribute (as a facet) from the request if it is present. Example: Suppose the query is &quot;shoes&quot;, the Condition.query_terms is &quot;shoes&quot; and the attribute name &quot;size&quot;, then facet key &quot;size&quot; will be removed from the request (if it is present). # Remove an attribute as a facet in the request (if present).
      &quot;attributeNames&quot;: [ # The attribute names (i.e. facet keys) to remove from the dynamic facets (if present in the request). There can&#x27;t be more 3 attribute names. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters.
        &quot;A String&quot;,
      ],
    },
    &quot;replacementAction&quot;: { # Replaces a term in the query. Multiple replacement candidates can be specified. All `query_terms` will be replaced with the replacement term. Example: Replace &quot;gShoe&quot; with &quot;google shoe&quot;. # Replaces specific terms in the query.
      &quot;queryTerms&quot;: [ # Terms from the search query. Will be replaced by replacement term. Can specify up to 100 terms.
        &quot;A String&quot;,
      ],
      &quot;replacementTerm&quot;: &quot;A String&quot;, # Term that will be used for replacement.
      &quot;term&quot;: &quot;A String&quot;, # Will be [deprecated = true] post migration;
    },
    &quot;twowaySynonymsAction&quot;: { # Creates a set of terms that will be treated as synonyms of each other. Example: synonyms of &quot;sneakers&quot; and &quot;shoes&quot;: * &quot;sneakers&quot; will use a synonym of &quot;shoes&quot;. * &quot;shoes&quot; will use a synonym of &quot;sneakers&quot;. # Treats a set of terms as synonyms of one another.
      &quot;synonyms&quot;: [ # Defines a set of synonyms. Can specify up to 100 synonyms. Must specify at least 2 synonyms.
        &quot;A String&quot;,
      ],
    },
  },
  &quot;searchSolutionUseCase&quot;: [ # Specifies the use case for the control. Affects what condition fields can be set. Only settable by search controls. Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified. Currently only allow one search_solution_use_case per control.
    &quot;A String&quot;,
  ],
  &quot;solutionTypes&quot;: [ # Required. Immutable. The solution types that the control is used for. Currently we support setting only one type of solution at creation time. Only `SOLUTION_TYPE_SEARCH` value is supported at the moment. If no solution type is provided at creation time, will default to SOLUTION_TYPE_SEARCH.
    &quot;A String&quot;,
  ],
}

  updateMask: string, Indicates which fields in the provided Control to update. The following are NOT supported: * Control.name If not set or empty, all supported fields are updated.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Configures dynamic metadata that can be linked to a ServingConfig and affect search or recommendation results at serving time.
  &quot;associatedServingConfigIds&quot;: [ # Output only. List of serving config ids that are associated with this control in the same Catalog. Note the association is managed via the ServingConfig, this is an output only denormalized view.
    &quot;A String&quot;,
  ],
  &quot;displayName&quot;: &quot;A String&quot;, # Required. The human readable control display name. Used in Retail UI. This field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is thrown.
  &quot;name&quot;: &quot;A String&quot;, # Immutable. Fully qualified name `projects/*/locations/global/catalogs/*/controls/*`
  &quot;rule&quot;: { # A rule is a condition-action pair * A condition defines when a rule is to be triggered. * An action specifies what occurs on that trigger. Currently rules only work for controls with SOLUTION_TYPE_SEARCH. # A rule control - a condition-action pair. Enacts a set action when the condition is triggered. For example: Boost &quot;gShoe&quot; when query full matches &quot;Running Shoes&quot;.
    &quot;boostAction&quot;: { # A boost action to apply to results matching condition specified above. # A boost action.
      &quot;boost&quot;: 3.14, # Strength of the condition boost, which must be in [-1, 1]. Negative boost means demotion. Default is 0.0. Setting to 1.0 gives the item a big promotion. However, it does not necessarily mean that the boosted item will be the top result at all times, nor that other items will be excluded. Results could still be shown even when none of them matches the condition. And results that are significantly more relevant to the search query can still trump your heavily favored but irrelevant items. Setting to -1.0 gives the item a big demotion. However, results that are deeply relevant might still be shown. The item will have an upstream battle to get a fairly high ranking, but it is not blocked out completely. Setting to 0.0 means no boost applied. The boosting condition is ignored.
      &quot;productsFilter&quot;: &quot;A String&quot;, # The filter can have a max size of 5000 characters. An expression which specifies which products to apply an action to. The syntax and supported fields are the same as a filter expression. See SearchRequest.filter for detail syntax and limitations. Examples: * To boost products with product ID &quot;product_1&quot; or &quot;product_2&quot;, and color &quot;Red&quot; or &quot;Blue&quot;: *(id: ANY(&quot;product_1&quot;, &quot;product_2&quot;)) * *AND * *(colorFamilies: ANY(&quot;Red&quot;, &quot;Blue&quot;)) *
    },
    &quot;condition&quot;: { # Metadata that is used to define a condition that triggers an action. A valid condition must specify at least one of &#x27;query_terms&#x27; or &#x27;products_filter&#x27;. If multiple fields are specified, the condition is met if all the fields are satisfied e.g. if a set of query terms and product_filter are set, then only items matching the product_filter for requests with a query matching the query terms wil get boosted. # Required. The condition that triggers the rule. If the condition is empty, the rule will always apply.
      &quot;activeTimeRange&quot;: [ # Range of time(s) specifying when Condition is active. Condition true if any time range matches.
        { # Used for time-dependent conditions. Example: Want to have rule applied for week long sale.
          &quot;endTime&quot;: &quot;A String&quot;, # End of time range. Range is inclusive.
          &quot;startTime&quot;: &quot;A String&quot;, # Start of time range. Range is inclusive.
        },
      ],
      &quot;pageCategories&quot;: [ # Used to support browse uses cases. A list (up to 10 entries) of categories or departments. The format should be the same as UserEvent.page_categories;
        &quot;A String&quot;,
      ],
      &quot;queryTerms&quot;: [ # A list (up to 10 entries) of terms to match the query on. If not specified, match all queries. If many query terms are specified, the condition is matched if any of the terms is a match (i.e. using the OR operator).
        { # Query terms that we want to match on.
          &quot;fullMatch&quot;: True or False, # Whether this is supposed to be a full or partial match.
          &quot;value&quot;: &quot;A String&quot;, # The value of the term to match on. Value cannot be empty. Value can have at most 3 terms if specified as a partial match. Each space separated string is considered as one term. For example, &quot;a b c&quot; is 3 terms and allowed, but &quot; a b c d&quot; is 4 terms and not allowed for a partial match.
        },
      ],
    },
    &quot;doNotAssociateAction&quot;: { # Prevents `query_term` from being associated with specified terms during search. Example: Don&#x27;t associate &quot;gShoe&quot; and &quot;cheap&quot;. # Prevents term from being associated with other terms.
      &quot;doNotAssociateTerms&quot;: [ # Cannot contain duplicates or the query term. Can specify up to 100 terms.
        &quot;A String&quot;,
      ],
      &quot;queryTerms&quot;: [ # Terms from the search query. Will not consider do_not_associate_terms for search if in search query. Can specify up to 100 terms.
        &quot;A String&quot;,
      ],
      &quot;terms&quot;: [ # Will be [deprecated = true] post migration;
        &quot;A String&quot;,
      ],
    },
    &quot;filterAction&quot;: { # * Rule Condition: - No Condition.query_terms provided is a global match. - 1 or more Condition.query_terms provided are combined with OR operator. * Action Input: The request query and filter that are applied to the retrieved products, in addition to any filters already provided with the SearchRequest. The AND operator is used to combine the query&#x27;s existing filters with the filter rule(s). NOTE: May result in 0 results when filters conflict. * Action Result: Filters the returned objects to be ONLY those that passed the filter. # Filters results.
      &quot;filter&quot;: &quot;A String&quot;, # A filter to apply on the matching condition results. Supported features: * filter must be set. * Filter syntax is identical to SearchRequest.filter. For more information, see [Filter](/retail/docs/filter-and-order#filter). * To filter products with product ID &quot;product_1&quot; or &quot;product_2&quot;, and color &quot;Red&quot; or &quot;Blue&quot;: *(id: ANY(&quot;product_1&quot;, &quot;product_2&quot;)) * *AND * *(colorFamilies: ANY(&quot;Red&quot;, &quot;Blue&quot;)) *
    },
    &quot;forceReturnFacetAction&quot;: { # Force returns an attribute/facet in the request around a certain position or above. * Rule Condition: Must specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for browse only), but can&#x27;t specify both. * Action Inputs: attribute name, position * Action Result: Will force return a facet key around a certain position or above if the condition is satisfied. Example: Suppose the query is &quot;shoes&quot;, the Condition.query_terms is &quot;shoes&quot;, the ForceReturnFacetAction.FacetPositionAdjustment.attribute_name is &quot;size&quot; and the ForceReturnFacetAction.FacetPositionAdjustment.position is 8. Two cases: a) The facet key &quot;size&quot; is not already in the top 8 slots, then the facet &quot;size&quot; will appear at a position close to 8. b) The facet key &quot;size&quot; in among the top 8 positions in the request, then it will stay at its current rank. # Force returns an attribute as a facet in the request.
      &quot;facetPositionAdjustments&quot;: [ # Each instance corresponds to a force return attribute for the given condition. There can&#x27;t be more 15 instances here.
        { # Each facet position adjustment consists of a single attribute name (i.e. facet key) along with a specified position.
          &quot;attributeName&quot;: &quot;A String&quot;, # The attribute name to force return as a facet. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters long.
          &quot;position&quot;: 42, # This is the position in the request as explained above. It should be strictly positive be at most 100.
        },
      ],
    },
    &quot;ignoreAction&quot;: { # Prevents a term in the query from being used in search. Example: Don&#x27;t search for &quot;shoddy&quot;. # Ignores specific terms from query during search.
      &quot;ignoreTerms&quot;: [ # Terms to ignore in the search query.
        &quot;A String&quot;,
      ],
    },
    &quot;onewaySynonymsAction&quot;: { # Maps a set of terms to a set of synonyms. Set of synonyms will be treated as synonyms of each query term only. `query_terms` will not be treated as synonyms of each other. Example: &quot;sneakers&quot; will use a synonym of &quot;shoes&quot;. &quot;shoes&quot; will not use a synonym of &quot;sneakers&quot;. # Treats specific term as a synonym with a group of terms. Group of terms will not be treated as synonyms with the specific term.
      &quot;onewayTerms&quot;: [ # Will be [deprecated = true] post migration;
        &quot;A String&quot;,
      ],
      &quot;queryTerms&quot;: [ # Terms from the search query. Will treat synonyms as their synonyms. Not themselves synonyms of the synonyms. Can specify up to 100 terms.
        &quot;A String&quot;,
      ],
      &quot;synonyms&quot;: [ # Defines a set of synonyms. Cannot contain duplicates. Can specify up to 100 synonyms.
        &quot;A String&quot;,
      ],
    },
    &quot;pinAction&quot;: { # Pins one or more specified products to a specific position in the results. * Rule Condition: Must specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for browse only), but can&#x27;t specify both. * Action Input: mapping of `[pin_position, product_id]` pairs (pin position uses 1-based indexing). * Action Result: Will pin products with matching ids to the position specified in the final result order. Example: Suppose the query is `shoes`, the Condition.query_terms is `shoes` and the pin_map has `{1, &quot;pid1&quot;}`, then product with `pid1` will be pinned to the top position in the final results. If multiple PinActions are matched to a single request the actions will be processed from most to least recently updated. Pins to positions larger than the max allowed page size of 120 are not allowed. # Pins one or more specified products to a specific position in the results.
      &quot;pinMap&quot;: { # Required. A map of positions to product_ids. Partial matches per action are allowed, if a certain position in the map is already filled that `[position, product_id]` pair will be ignored but the rest may still be applied. This case will only occur if multiple pin actions are matched to a single request, as the map guarantees that pin positions are unique within the same action. Duplicate product_ids are not permitted within a single pin map. The max size of this map is 120, equivalent to the max [request page size](https://cloud.google.com/retail/docs/reference/rest/v2/projects.locations.catalogs.placements/search#request-body).
        &quot;a_key&quot;: &quot;A String&quot;,
      },
    },
    &quot;redirectAction&quot;: { # Redirects a shopper to a specific page. * Rule Condition: Must specify Condition.query_terms. * Action Input: Request Query * Action Result: Redirects shopper to provided uri. # Redirects a shopper to a specific page.
      &quot;redirectUri&quot;: &quot;A String&quot;, # URL must have length equal or less than 2000 characters.
    },
    &quot;removeFacetAction&quot;: { # Removes an attribute/facet in the request if is present. * Rule Condition: Must specify non-empty Condition.query_terms (for search only) or Condition.page_categories (for browse only), but can&#x27;t specify both. * Action Input: attribute name * Action Result: Will remove the attribute (as a facet) from the request if it is present. Example: Suppose the query is &quot;shoes&quot;, the Condition.query_terms is &quot;shoes&quot; and the attribute name &quot;size&quot;, then facet key &quot;size&quot; will be removed from the request (if it is present). # Remove an attribute as a facet in the request (if present).
      &quot;attributeNames&quot;: [ # The attribute names (i.e. facet keys) to remove from the dynamic facets (if present in the request). There can&#x27;t be more 3 attribute names. Each attribute name should be a valid attribute name, be non-empty and contain at most 80 characters.
        &quot;A String&quot;,
      ],
    },
    &quot;replacementAction&quot;: { # Replaces a term in the query. Multiple replacement candidates can be specified. All `query_terms` will be replaced with the replacement term. Example: Replace &quot;gShoe&quot; with &quot;google shoe&quot;. # Replaces specific terms in the query.
      &quot;queryTerms&quot;: [ # Terms from the search query. Will be replaced by replacement term. Can specify up to 100 terms.
        &quot;A String&quot;,
      ],
      &quot;replacementTerm&quot;: &quot;A String&quot;, # Term that will be used for replacement.
      &quot;term&quot;: &quot;A String&quot;, # Will be [deprecated = true] post migration;
    },
    &quot;twowaySynonymsAction&quot;: { # Creates a set of terms that will be treated as synonyms of each other. Example: synonyms of &quot;sneakers&quot; and &quot;shoes&quot;: * &quot;sneakers&quot; will use a synonym of &quot;shoes&quot;. * &quot;shoes&quot; will use a synonym of &quot;sneakers&quot;. # Treats a set of terms as synonyms of one another.
      &quot;synonyms&quot;: [ # Defines a set of synonyms. Can specify up to 100 synonyms. Must specify at least 2 synonyms.
        &quot;A String&quot;,
      ],
    },
  },
  &quot;searchSolutionUseCase&quot;: [ # Specifies the use case for the control. Affects what condition fields can be set. Only settable by search controls. Will default to SEARCH_SOLUTION_USE_CASE_SEARCH if not specified. Currently only allow one search_solution_use_case per control.
    &quot;A String&quot;,
  ],
  &quot;solutionTypes&quot;: [ # Required. Immutable. The solution types that the control is used for. Currently we support setting only one type of solution at creation time. Only `SOLUTION_TYPE_SEARCH` value is supported at the moment. If no solution type is provided at creation time, will default to SOLUTION_TYPE_SEARCH.
    &quot;A String&quot;,
  ],
}</pre>
</div>

</body></html>